home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir39 / arconv01.zip / README.TXT < prev    next >
Text File  |  1993-06-29  |  9KB  |  160 lines
  1.                  4ARCCONV Easy archiving with 4DOS
  2.                   Release 1.0, 21/6/93, By E.T.C
  3.                         Brief introduction
  4.  
  5.  
  6. 1) What this package is?
  7.  
  8.   This package contains several script files for 4DOS (If you don't know
  9. what 4DOS is, you'd better download it first before you continue).
  10. The scripts included enable the user to handle archive files very comfortably.
  11. By handling, I include creating, extracting, converting from one archiver to
  12. another, logging conversions (and optionally calculating statistics on them).
  13. By comfortably, I mean that in very few keystrokes, the scripts can do various,
  14. possibly tedious tasks, and try to do it in the easiest way (for the user, not
  15. the computer). It enables the user to automate many of his/her archiving-
  16. chores. Currently, it recognizes most DOS archive formats, and some of UNIX's.
  17.  
  18. 2) For whom is this package?
  19.  
  20.    The need for these scripts arose from the frequent appearance of new
  21. archivers, or new version of archivers: I was always inclined to convert
  22. my archive files to a tighter or a faster archiver when one appeared. 
  23. Besides, it helped me keep most of my archives in one, standard format, no
  24. matter in which format I obtained it. Therefore, I think power-users may
  25. benefit most from this package. Much of the power of this package is its
  26. modifiability and uniformity, (which is probably the main advantage of BTM
  27. scripts over executables). However, I wrote it to be as simple, user friendly,
  28. and modifiable as I could (Though not in the cost of functionality).
  29. This makes this package usable and comprehensible, in my opinion, even to
  30. DOS & 4DOS newbies (well, I'm a 4DOS newbie too, I think :-).
  31.    I'm not a great believer in menus and windows. I like simple and clear
  32. command line interface. If you agree, this is the archive handler for you.
  33. If you don't agree. this package may still offer you things others don't.
  34. Why use this package when there are so many other programs and 4DOS scripts
  35. around? Here are my answers:
  36. - It has some useful features others don't.
  37. - It's real easy to modify, unlike .EXE files, or some 4DOS scripts.
  38. - It's FREE!
  39. - Simple, short, command line interface, This enables batch processing!
  40.  
  41. 3) What can I do with these scripts?
  42.  
  43.   The following scripts are included, in increasing order of complexity:
  44.  
  45. -DA.BTM: This script unpacks an archive. For example, you type DA TEST.ZIP, 
  46.        and the script will figure out how to unpack it, (using the extension,
  47.        or with a default archiver if no extension is given), and will unzip
  48.        the archive to the current directory. Of course, you may pass extra
  49.        options to the archiver, like DA -q TEST.ZIP, etc. It also enables you
  50.        to set the de-archiving defaults. For example, DA.BTM is set by-
  51.        default to create all subdirectories in the archive, whenever relevant.
  52.        The main advantage of this script is that it offers a uniform interface
  53.        to all DeArchiving - Once you install an archive-unpacker, and add it
  54.        to DA.BTM (which is really easy), you can forget how to operate it.
  55. -A.BTM:  This script is the opposite of DA: it creates archives. You can 
  56.        choose which archiver to use, or ignore it and let it use its default
  57.        archive. Although you can pass to it an archiver's specific options, 
  58.        there's a 'global' option for A.BTM: -r. This option indicates that  
  59.        all subdirectories are to be included as well. Also, if no filenames to
  60.        archive are given, it'll try to store all files. Note, that this will
  61.        require from you a little effort when adding a new archiver that hasn't
  62.        got the option -r, or must have filenames to store given to it, but there
  63.        are various examples how to do it inside A.BTM. (This is needed for TO).
  64.        Run A with no arguments to see the syntax description.
  65. -TO.BTM: This is the most useful script: It enables you to convert with little
  66.        effort and with various error checks from one archive type to another.
  67.        For exact syntax, run TO with no args. Note that if you don't specify
  68.        to which archive format you wish to convert, there's a default value you
  69.        can set (e.g typing TO *.ZOO will convert all the ZOO files in the
  70.        current directory, and convert them to your default archive format).
  71.        TO's options include deleting the original archive, or the smaller-
  72.        archive (with prompting, or without, for batch mode).
  73.        Furthermore, it can keep a log of the conversions, which can be later
  74.        processed by COMPSTAT.BTM
  75.  
  76.    If you choose to enable the logging in TO.BTM, then the file COMPSTAT.BTM
  77.  is created, which is a script that uses COMPSTAT.AWK to generate a table of
  78.  percentage gained in average. by converting from archiver x to archiver y.
  79.  You can easily determine which archivers will appear in the table, by I think
  80.  the default ones cover the major archivers.
  81.  
  82.    Most documentation for these scripts are within. Just run them with no args,
  83.  to get a good description of syntax and options. Compstat doesn't have doc, 
  84.  but I don't think it needs any: It just creates a table where the <x,y>
  85.  entry tells what's the % gained in avg by converting from format x to format y.
  86.  If you want to tinker with it, first read gawk's manual, then consult me.
  87.  
  88.    IMPORTANT NOTE: You cannot use compstat without a GAWK compatible program.
  89.  (It may work on AWK as well, but I haven't tested it). GAWK is GNU's version
  90.  of the AWK interpreter, and can be found in any major ftp site.
  91.  
  92. 4) Installation
  93.  
  94.    Easy does it. Just type install, and answer the questions. The scripts
  95. will be assembled according to your answers. (I know this isn't the most
  96. efficient way of doing it, but remember: modifiability and simplicity...)
  97. It would be a good idea now to visit the .BTM files with an editor. Though
  98. the files are ready to run, and quite usable, you may want to change their
  99. default archiver (Do this by modifying the statement DEFAULT= in the beginning
  100. of the file to any other usable label, according to the example given). 
  101. You can also change the archiver's default options . For example, PKZIP
  102. currently uses maximum compression by default. You can change it to minimum-
  103. time compression, or anything else, inc. no default options.
  104.  
  105.  
  106. 5) Legalities
  107.  
  108.    Hate this part... Well here goes:
  109.  
  110. I give no warranty whatsoever, expressed or implied about the correctness or
  111. fitness for a particular purpose of this package, or any part of it, inc. the
  112. documentation. If you use any part of this package you consent not to find 
  113. me liable for any damages resulting from misuse, abuse, or any usage at all 
  114. of it. Since I free you of any financial obligations for usage of this
  115. package, I expect you to do the same. If you don't like it, don't use any
  116. of the files. If you are not sure, backup your hard-disk :-).
  117. I assume no obligation to assist, support, fix bugs, or add documentation, 
  118. except for what's written in paragraph 6 below. This means you CAN ask me to
  119. help, but I cannot guarantee that I'll be able too.
  120.  
  121. You may distribute and use this package freely as long as:
  122. a) All files are included.
  123. b) This file is included UNMODIFIED.
  124. c) You must comment any modification you make in the original files (yeah,
  125.    of course you're allowed to tinker with it).
  126.  
  127. 4DOS is a registered trademark of J.P. Software
  128. ARJ is a registered trademark of Robert K. Jung
  129. PKZIP is a registered trademark of PKWARE
  130. Any other trademarks found herein are the property of their respective owners.
  131.  
  132.  
  133. 6) Registration / Reaching me.
  134.  
  135.  
  136.    I don't ask for any money at all. However, there's some 'special' 
  137. registration which entitles you to free upgrades on new releases/bug fixes
  138. by email only, provided that I have an email account. In order to 'register',
  139. all you have to do is send me mail with a critique: suggestions or bug report,
  140. tell me what you dislike, what should be documented in more detail,
  141. or anything you find relevant. You will be included in a mailing list.
  142. If the mailing list grows too big, I'll just send updates when new versions
  143. are uploaded somewhere, instead of mailing it.
  144. P.S - If there's general demand, I'll try to make TO.BTM run over a sub-tree
  145. as well, so if you want it, let me know.
  146.  
  147. NOTE: Any of the above can be changed without prior notice ('cause I'm not
  148. a very good lawyer, that's why...)
  149.  
  150. I can be reached at:
  151.  
  152. Email: etc@cs.huji.ac.il
  153. Smail: Eitan Frachtenberg,
  154.        P.O box 163,
  155.        Jerusalem, 
  156.        Israel.
  157.  
  158. Have fun!
  159.  
  160.